home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / dirwork1.62 / dwedit.doc < prev    next >
Text File  |  1995-03-27  |  31KB  |  802 lines

  1. DWEdit V1.62a (41468 bytes)   The configuration editor for DirWork 1.62
  2. -----------------------------------------------------------------------
  3.  
  4. This program may be copied as long as it is accompanied by this doc file
  5. both unaltered & no money is charged(except for a reasonable copying fee
  6. such as what Fred Fish charges).  All use of this program is at your own
  7. risk & I assume no responsibility or liability for any problems that occur.
  8.  
  9.  
  10.     Well you can change most options/buttons etc from DirWork but
  11. DWEdit allows you to edit some others as well as making the configuration
  12. process a lot easier.  To start DWEdit(assuming DWEdit is in a valid path
  13. eg c:):-
  14.  
  15. Select the "Use external configuration Editor" menu item from in DirWork
  16. (Best way!).  Note if you do this and select Quit & Use, most changes appear
  17. in DW immediately, but if you want those changes always you must select the
  18. "SAVE Current Setup to a DW" menu item.
  19.  
  20. From a Shell/CLI type "DWEdit DWFileName".
  21.  
  22. From a Shell/CLI type "DWEdit s:DW.config".
  23.  
  24.     For DirWork 1.31, 1.40 - 1.61 users you can load in the previous
  25. Button/Instant Actions and PopKey/Tool data.  Menu type Options aren't
  26. loaded.  Things change so some converting is done but new options might be
  27. better so have a look.
  28. From a Shell/CLI type "DWEdit DWFileName OldDWFileName".
  29.  
  30.  
  31.     Then if everything is ok you will be presented with a screen with
  32. all the DirWork Buttons as well as buttons for the left/middle/right mouse
  33. button instant actions.  You can select one of the main buttons:-
  34.  
  35. Quit        - Quit without keeping any changes made.
  36. Quit & Use    - Quit and keep changes(this appears if you run from DW).
  37. Quit & Save    - Quit and save changes to disk(when not run from DW).
  38. Options        - Takes you to a screen of options.
  39. Ed PopTools    - Takes you to the PopKey/Tools screen.
  40. Print Config    - Prints your Button/InstantAction & PopTool to PRT:.
  41.  
  42.     When the mouse is over a Button/Instant Action the current config
  43. for that button is shown at the bottom of the display.  Pressing the button
  44. takes you to a Button/Instant Action editing screen.
  45.  
  46.     There are three toggle buttons on the main screen as well.  You can
  47. select SwapButton then press buttons to swap them, then select swap button
  48. again to turn it off.  Same goes for SwapRow.  CopyBut is like swap button
  49. but the button is copied.
  50.  
  51. ----------------------------------------------------------------------------
  52.         The Options screen
  53. ----------------------------------------------------------------------------
  54.  
  55.     Here you can change many options that you couldn't from DirWork
  56. itself:-
  57.  
  58. OPTIONS THAT TOGGLE ON/OFF
  59.  
  60. AutoPoint    Automatically select windows the mouse is over.
  61.         Often called SunMouse.
  62.  
  63. XCopyBootBlocks    The Boot block checker will treat Xcopy Boot blocks as if
  64.         they are standard boot blocks.
  65.         (ie won't warn you when you insert a disk with one)
  66.  
  67. ActivateTextGad    After getting a directory DirWork will activate the text
  68.         gadget.
  69.  
  70. NoDWDuplicates    When you have one DW running and try to start another it
  71.         will just bring the one running to the front.
  72.  
  73. ExternalConfig    This makes DirWork use "S:DW.config" and its
  74.         configuration file instead of using the DW executable.
  75.         Maybe you would like to crunch DirWork and keep changing
  76.         your config.
  77.  
  78. ButtonsBelow    If you are one of those upsidedown people this will put the
  79.         buttons etc below the file list for you.
  80.  
  81. PositionIndepen    This makes the button position irrelevant to what file list
  82.         it refers to.  You have to press the right mouse button
  83.         on the button to refer to the right list as the source.
  84.         Plenty of people use DW this way as you don't have to
  85.         have duplicates of many buttons.
  86.  
  87. MouseAccelerat    Accelerates your mouse based on values given in Accel and
  88.         threshold.
  89.  
  90. NoWBenchTools    Stops DW from adding tools to the workbench screen in
  91.         Kickstart 2.0-.  Use this if you wish to quit from
  92.         Workbench as DW will not open Workbench if it doesn't
  93.         add Tools to the workbench menu.
  94.  
  95. More ANSI    The text viewer can display ANSI files so if you want it
  96.         to start in ANSI mode(its slower) select this option.
  97.  
  98. BusyPointer    A little Busy clock comes up when DW is already doing
  99.         something.  This is on by default.
  100.  
  101. RMB Activate    This causes right mouse button presses to activate the
  102.         DW window so you don't have to activate DW then use
  103.         the right mouse button.  This is on by default.
  104.  
  105. Parent Buf    If you have Buffered directories on this will
  106.         automatically use the buffered copy of a dir if you use
  107.         the parent/root functions on the far sides of the dir
  108.         path gadgets.  Eg if you got the directory DF0:c then
  109.         pressed the parent/root button it would use the buffered
  110.         copy instead of re-reading the DF0: dir.  It will only
  111.         use the buffered copy if you have not read other dirs
  112.         in between.
  113.  
  114. Interlace    Screen is interlaced for DW.
  115.         And for the text viewer.
  116.  
  117. Productivity    Screen is non interlaced.  Requires ECS chips in your
  118.         machine and a VGA or better monitor.
  119.         And for the text viewer.
  120.  
  121.  
  122.  
  123. OPTIONS YOU SET THE VALUE OF
  124.  
  125.  
  126. TaskPriority    The priority relative to other programs running of DW.
  127.         1 is usually a good value as it give DW more processor
  128.         time than most other programs.
  129.         Recommended range -5 to 5.
  130.  
  131. MouseAccel    The factor by which mouse movement will be multiplied by.
  132.         You must turn the mouse acceleration option on as well.
  133.         Recommended range 2 to 10.
  134.  
  135. MouseThreshhold    This is the smallest movement required before the mouse
  136.         acceleration factor is used.  So when you do small
  137.         movements no acceleration occurs and hence you have fine
  138.         control. A value of 1 means always multiply be MouseAccel.
  139.         You must turn the mouse acceleration option on as well.
  140.         Recommended range 1 to 20.
  141.  
  142. ScreenBlankTim    Amount of time the machine must be idle before the screen
  143.         blanks.  Assuming you have the ScreenBlank option on.
  144.         In tenths of a second so 4800=8 minutes.
  145.         Recommended range 2400 to 9600.
  146.  
  147. BufferedNumber    Number of directories keep in memory when you have the
  148.         buffered directory option turned on.
  149.         Recommened range 4 to 20.
  150.  
  151. VMKTime        Amount of time between VMK checks.  Assuming you have the
  152.         Periodic VMK check option on.
  153.         In tenths of a second so 80=8 seconds.
  154.         Recommended range 10 to 180.
  155.  
  156. LeftActivate    This is the Qualifier/Keycode of the key combination that
  157.         will activate(like you pressed the left button on gadget)
  158.         the left directory path text gadget.  By default this is
  159.         the Del key.
  160.  
  161. RightActivate    This is the Qualifier/Keycode of the key combination that
  162.         will activate(like you pressed the left button on gadget)
  163.         the right directory path text gadget.  By default this is
  164.         the Help key.
  165.  
  166.  
  167. WindowLeftEdge    The x coordinate of the top/left corner of windows DW opens
  168.         on the workbench screen and output windows.
  169.  
  170. WindowTopEdge    The y coordinate of the top/left corner of windows DW opens
  171.         on the workbench screen and output windows.
  172.  
  173. WindowWidth    The width of windows DW opens on the workbench screen and
  174.         output windows.
  175.  
  176. WindowHeight    The height of windows DW opens on the workbench screen
  177.         output windows.
  178.  
  179. ScreenWidth    The width of the screen DW opens.
  180.  
  181. ScreenHeight    The height of the screen DW opens.
  182.         And for the text viewer.
  183.  
  184. Colors13    These are the color numbers DW uses for a window Kick 1.3.
  185.         (0=Blue 1=White 2=Black 3=Orange by default colors)
  186. Colors20    These are the color numbers DW uses for a window Kick 2.0.
  187.         (0=Grey 1=Black 2=White 3=LightBlue by default colors)
  188. ColorsSc    These are the color numbers DW uses for screen.
  189.         They have the following sequence:-
  190.            First three for File lists (Background/Files/Dirs)
  191.            Next two for title bar (Text/Background)
  192.            Next two for button text (Text/Background)
  193.            Next one for menu/slider color
  194.            Next two for button border
  195.  
  196.         For example Colors13 by default is:
  197.            2133132100
  198.         File list is  213=BlackBackground/WhiteFiles/OrangeDirs
  199.         Title bar is 31=Orange on White
  200.         Buttons text is 32=OrangeText/Black
  201.         Button Border is 00=No border shown
  202.  
  203. SLIDE GADGETS AT BOTTOM
  204.  
  205.     The three slide gadgets are Red/Green/Blue modifiers for the screen
  206. palette for DW.  Just select a color button under the sliders then use the
  207. slide movement to adjust the colors.
  208.  
  209. ----------------------------------------------------------------------------
  210.         The Button/Instant Action editing screen
  211. ----------------------------------------------------------------------------
  212.  
  213.     This screen displays the function currently selected for that
  214. button with the main config string down the bottom and the various sections
  215. of this config above it.  The sections that are irrelevant for the current
  216. function are ghosted(dots across them and unselectable).  Above the config
  217. string gadgets is information text which can be selected from three buttons
  218. on the right hand side.
  219.  
  220.     GeneralInfo - Describes the various parts of a config string.
  221.  
  222.     SelectionInfo - Describes how selection affects a function.
  223.  
  224.     FunctionInfo - Describes the current function of the config.
  225.                    This is selected by default.
  226.  
  227.     As well on the right hand side is a change function button which
  228. allows you to change the button/instant action to another function.  As
  229. with the PopTool screen a Qualifier/Keycode box is on the right.  You can
  230. see what values a required for a button to be activated by a certain key
  231. combination by clicking on this box and pressing the keys you want.
  232.  
  233.  
  234. The button configuration is a single string consisting of:-        
  235. ------------------------------------------------------------------ 
  236. 'BName,FSOQuCo,Arguments'                                          
  237.  ||||| |||\__/||                                                   
  238.  |     ||| |  |+- Arguments for operation.                         
  239.  |     ||| |  +--- Special option for certain routines             
  240.  |     ||| +------- Keyboard combination (qualifier/keycode)       
  241.  |     ||+----------- Options for certain routines.                
  242.  |     |+--------------- What needs to be selected to operate.     
  243.  |     +----------------- Internal function the button uses.       
  244.  +-Button Name of 5 Chars
  245.    In the case of instant actions this text can describe filetype.
  246. ------------------------------------------------------------------ 
  247.  
  248.     Selection is only relevant to lower case functions as these are the
  249. only ones which deal with files(s)/dir(s) in the file lists.  For the lower
  250. case functions 'F' means apply function on all selected files, 'D' all
  251. selected dirs and 'B' all selected files and all selected dirs.  'A' all
  252. files and dirs even if they are not selected.  Another option is 'f' which
  253. will apply the function to all selected files but if there are no files
  254. selected it will apply the function with no filename.  'f' is great for
  255. creating buttons like Edit so that you can edit a selected file and if you
  256. want to create a new file just hit the Edit button with no files selected.
  257.  
  258. NOTE: Press return after any change in any text gadgets on this screen
  259.       otherwise your changes may not be registered.
  260.  
  261.     Ok so say you wanted to change the "DH0:  " button to "DF2:  " you
  262. would select that button from the main DWEdit screen then you would see
  263. that in the arguments is "DH0:" so click in that text gadget change it to
  264. "DF2:" then press return.  Now that button will read "DF2:" but you will
  265. also want to change the button text so click in that text gadget and change
  266. it to "DF2:  " note that it must be 5 characters no more no less.  Press
  267. Quit & USe or Quit & Save and you will see the button now has a new Button
  268. text and when you press it reads the new directory("DF2").
  269.  
  270.     Plenty of functions have options which a described in the Function
  271. Info text.  If you wanted the show button to show icons as well all you
  272. would do is go to DWEdit's main screen select the show button.  Then you
  273. will see the text saying that you must change the option to i to get the
  274. show function to display icons as well as IFF pictures.  So click in the
  275. Option gadget change the 0 to i and it is done.
  276.  
  277.     Maybe you want a button to relabel disks.  In DWEdit's main screen
  278. just click on the button that you want to be relabel.  Then the current
  279. config for that button comes up.  Ignore that and press the change function
  280. button on the right hand side of the screen.  Now you get a display of all
  281. the available functions in DW, press the L function button which says
  282. relabels disks or similar.  Now you are back to the config screen and the
  283. default config function has been entered in the button config.
  284.  
  285.     Ok say you want to change the instant action for double clicking on
  286. a text file to use a external viewer.  In DWEdit's main screen click on the
  287. Text button for left mouse instant actions.  Now the button is using
  288. function t (inbuilt text viewer function) but you want to use an external
  289. program so select change function button on right hand side of display and
  290. you will see the many available functions, you will see the function u with
  291. a description that it runs external programs so select it.  Then its back
  292. to the button config screen in which you must change the Buttontext back to
  293. what it was as instant actions need the Button text to remain the same and
  294. all you have to do is change the arguments to run you external program
  295. which could be something like "Run >NIL:  MuchMore" or similar.  Note it
  296. might have been quicker if you knew u was the function you where after as
  297. you would have skipped the change function button stuff and manually
  298. entered the u into the function text gadget and avoided having to change
  299. the Buttontext back to what it was.
  300.     
  301.  
  302.     Well they are simple examples of changes you can do very powerful
  303. changes to run external programs, cd directories, open windows, and flip
  304. between screens.  See the SAMPLE CHANGES section for other examples.
  305.  
  306.  
  307.     If you want to create a new instant action type say you have
  308. certain files that end in ".pcd".  You must replace one of the current ones
  309. and change all three Button text's (Left, Middle & Right) to ".PCD " (note
  310. that it must be in uppercase).  But do NOT change ILBM, 8SVX, ANIM, SMUS,
  311. FTXT, Most, PP, Exec, Text, .GIF as they are not only recognised by
  312. filename.
  313.  
  314. SAMPLE CHANGES FOR BUTTONS/INSTANT ACTIONS:-
  315.  
  316. ---------------------------------------------------------------------------
  317. Routine| Example changes and Information
  318. letter | Remember upper case routine letter means selected file(s) related.
  319. ---------------------------------------------------------------------------
  320. D    A simple change would be changing DH1: to DF2: and make the F1 key
  321.     get that directory.  Just select the DH1: button, go up to change
  322.     last button pressed and change
  323.     " DH1:,D00----,DH1:" to " DF2:,D000050,DF2:".
  324.  
  325.     To make a button that gets the directory already in the text gadget
  326.     (instead of just pressing the right mouse button over the gadget)
  327.     "GetDr,D0c----,"
  328.  
  329. N    Executes commands. Use this function if you want to execute a program
  330.     and don't want the selected files to be added to the command.
  331.     You must add CTRL-J EndCLI to your command if you use a option
  332.     that opens a window(w,W,p,P) and you want it to automatically close.
  333.  
  334.     Options(w,W,p,P,f,F,t,T,R,0):-
  335.  
  336.        Uppercase of any of these letters means a requester first.
  337.  
  338.        w if you want a window to open for the output.
  339.        p if you want a window to open for the output and waits for you
  340.          to press a key before it closes.
  341.        f bring default public screen(usually workbench) to the front.
  342.        t bring default public screen(usually workbench) to front for 
  343.          command then DW screen.
  344.  
  345.        R if you want a requester so you can edit the command before
  346.          it is executed.
  347.        0 means no window or requester or bringing screens to the front.
  348.  
  349.     SpecialOp(s,S,d,D,',')
  350.  
  351.        Lower case special option means refetch the src or des directory
  352.        after commands are executed.
  353.  
  354.        s CD source directory before command.
  355.        d CD destination directory before command.
  356.        , as normal do no CD'ing.
  357.  
  358.     Examples:-
  359.  
  360.     "Prefs,N00----,Preferences"  Bring up 1.2/1.3 preferences.
  361.                              No output window is opened.
  362.  
  363.     "Paint,N00----,Run >NIL: Paint"  Start a paint program but
  364.                                      allow DW to continue.
  365.  
  366.     "Avail,N0p----,AvailJEndCLI"   Show available memory in a window.
  367.                                Then automatically close that window
  368.                                after the user presses a key (or clicks
  369.                                on the close gadget with Kick2.0+).
  370.                                    Note the J is CTRL-J
  371.  
  372.     "Avail,N0w----,List"   List a directory in a output window that stays
  373.                        open until the user enters EndCLI (or clicks
  374.                        on the close gadget with Kick2.0+).
  375.  
  376.     "DiskC,N0w----,DiskCopy DF0: TO DF0:JEndCLI"  Diskcopy DF0: to DF0:
  377.                                               opening a window for
  378.                                               the output that auto
  379.                                               closes when the Diskcopy
  380.                                               is finished.
  381.                                                   Note the J is CTRL-J
  382.  
  383. M    The Makedir function can be given a filename which it will copy
  384.     to create a icon for the directory.  All you have to do is give
  385.     it the filename of the icon you want it to create.
  386.     "MakDr,M00----,sys:DefaultDraw.info"
  387.  
  388.  
  389. P    To create a parent button if you don't like going to the far
  390.     left/right of the directory text and pressing the left button.
  391.     "Paren,P00----,"
  392.  
  393. R    To create a root button if you don't like going to the far
  394.     left/right of the directory text and pressing the right button.
  395.     "Root ,R00----,"
  396.  
  397.  
  398. t    Is the Type/Hextype function.  Options are
  399.     A=ASCII H=Hex (try to load full file)
  400.     a=ASCII h=Hex (Only load first 32K of file)
  401.  
  402. j    Options(f,F,d,D,b,B,p,P) Uppercase=DeSelect LowerCase=Select
  403.     To make a button select dirs as well as files.
  404.     "All  ,jAb----,"
  405.     To make a button select all dirs.
  406.     "AllDr,jAd----,"
  407.     To make a button deselect all dirs.
  408.     "NoDir,jAD----,"
  409.     To make a button that request you for a pattern that deselects
  410.     "PtDSl,jAP----,"
  411.  
  412. s    To make a show button display icons as well as IFF pictures.
  413.     "Show ,sFi----,"
  414.  
  415. k    Options(c,C,t,T,s,S) Uppercase requester user can edit first
  416.     t=toggle protection s=setprotection c=set comment
  417.     The Protect function inverses the protect bit specified in the
  418.     So "Prote,kBt----,d" will change the delete protection of a file.
  419.  
  420.     "PNorm,kBs----,rwed" would set all files/dirs to normal protection.
  421.  
  422.     "SetCm,kFs----,DW Rules!" would set all files comments to DW Rules!
  423.  
  424.     "ClrCm,kDS----," would request user for comment then set all dirs
  425.                      comments to it.
  426.  
  427.  
  428. d    To make a delete button that doesn't request you when you delete a
  429.     non empty dir.
  430.     Options (d,D,b,B)
  431.     "Delet,dB0----,"
  432.     A delete button that requests you when you delete a file
  433.     or a directory:-
  434.     "Delet,dBB----,"
  435.     The lower case letter option means that if Delete fails it will
  436.     prompt you and if you want will UnProtect each file and try to
  437.     delete again.
  438.  
  439. c    Options (c,D,C)
  440.     To make a copy button clone the file note, protection and date.
  441.     BytesFree for the source/destination is updated after a copy.
  442.     "CCopy,cBc----,"
  443.     To make a CopyAs button that clones
  444.     "CCpAs,cBC----,"
  445.     To make a CopyAs button that doesn't clone
  446.     "CCpAs,cBD----,"
  447.     To make a Copy button that doesn't clone
  448.     "CCpAs,cB0----,"
  449.  
  450. m    To make a move button clone the file note, protection and date.
  451.     "CMove,mBc----,"
  452.  
  453. u    The u internal routine is one of the most useful it will execute
  454.     the text in the argument part of the button config with any any
  455.     file/dirnames selected.  If you want the button to operate on
  456.     selected files and directories use the B middle letter.  If you
  457.     want it just to operate on selected files use F and if you just
  458.     want it to operate only on selected Dirs use D.  There is another
  459.     selection that is useful for this function, 'f' will execute the
  460.     command with all selected files but if there are none selected
  461.     it executes the command with no filename.  Note the u command
  462.     automatically adds JEndCLI (where J is CTRL-J) to commands
  463.     that use an option that opens a window(w,W,p,P).
  464.  
  465.     Options(w,W,p,P,f,F,t,T,R):-
  466.  
  467.        Uppercase of any of these letters means a requester first.
  468.  
  469.        w if you want a window to open for the output.
  470.        p if you want a window to open for the output and waits for you
  471.          to press a key before it closes.
  472.        f bring default public screen(usually workbench) to the front.
  473.        t bring default public screen(usually workbench) to front for 
  474.          command then DW screen.
  475.  
  476.        R if you want a requester so you can edit the command before
  477.          it is executed.
  478.        0 means no window or requester or bringing screens to the front.
  479.  
  480.     SpecialOp(s,S,d,D,',')
  481.  
  482.        Lower case special option means refetch the src or des directory
  483.        after commands are executed.
  484.  
  485.        s CD source directory before command.
  486.        d CD destination directory before command.
  487.        , as normal do no CD'ing.
  488.  
  489.     An example of using the u routine is the edit button and right mouse
  490.     instant operation on text files:- " Edit,uF0----,Run >NIL: E"
  491.     To change to path for the editor from E to c:Ed just select the edit
  492.     button, go up to change last button pressed and change to
  493.     " Edit,uF0----,Run >NIL: c:Ed"
  494.     Note an output window is not needed hence the 0 as the option.
  495.     But it is even better to use the f selection with a edit button
  496.     as then you you select no files the editor is still executed and
  497.     you can use that method to create a new file for editing.
  498.  
  499.     To change the double click on a text file to use another text viewer
  500.     instead of the default internal type.  After you double click a
  501.     text file & select change last button pressed
  502.         "Text ,uF0,Run >NIL: ViewerName". eg "Text ,uF0,Run >NIL: MuchMore"
  503.  
  504.     To make a button that uses DOS's list command on selected files and
  505.     dirs, and shows the output in a window than stays open until the
  506.     user presses a key (or clicks the close gadget with Kick2.0-).
  507.     "List ,uBp----,List"
  508.  
  509.     To make a button that uses DOS's Execute command to execute script
  510.     files, with an output window open while the command is executing.
  511.     "Execu,uFw----,Execute"
  512.  
  513.     To make a button that uses DOS's FileNote command to change the
  514.     FileNote of a file in a requester.
  515.     "Execu,uFR----,FileNote"
  516.  
  517.     To make a button that extracts files to the same directory then
  518.     gets DW to re-read that directory, displaying the output from
  519.     the program in a window that automatically closes
  520.     ".LZH ,uFw----sLZ x"
  521.  
  522.  
  523. a    The a function is very similar to the u function except that it
  524.     adds "/*" to directory names and has its own output window so
  525.     there is no need to use an option to open one.
  526.  
  527.  
  528. b    Is the routine which displays the FileNote/protection bits so
  529.     "FBits,bB0----," would create a button for it instead of going to the
  530.     far right or left of the file/dir.
  531.  
  532.  
  533.  
  534.  
  535. Here is the default configuration of DW:-
  536.  
  537. "Instn,nF0----,",
  538. "Print,ifP----,",
  539. "Serch,fF0----,",
  540. "LZ A ,aB0----dLZ -r -x a ",
  541. "NewZP,uff----,Run >NIL: NewZAP",
  542. "CpyAs,cBD----,",
  543. "Info ,I00----,",
  544. " Info,I00----,",
  545. "DskOp,K00----,",
  546. "NewZP,uff----,Run >NIL: NewZAP",
  547. "Commd,N0w----,",
  548. "NewSh,N0f----,NewShell",
  549. "AdIcn,wB0----,",
  550. "Sleep,S00----,",
  551.  
  552. "EScpt,uFw----,Execute",
  553. "Prote,kBt----,d",
  554. "PlayS,pF0----,",
  555. "MakDi,M00----,",
  556. "HxTyp,tFH----,",
  557. "Delet,dBd----,",
  558. "Move ,mB0----,",
  559. " Move,mB0----,",
  560. "Delet,dBd----,",
  561. "HxTyp,tFH----,",
  562. "MakDi,M00----,",
  563. "PlayS,pF0----,",
  564. "Prote,kBt----,d",
  565. " VMK ,V00----,",
  566.  
  567. "PatSe,jAp----,",
  568. " Run ,ufR----,Run >NIL:",
  569. "Show ,sF0----,",
  570. "Edit ,uf0----,Run >NIL: E",
  571. "Type ,tFA----,",
  572. "Renam,rB0----,",
  573. "Copy ,cB0----,",
  574. " Copy,cB0----,",
  575. "Renam,rB0----,",
  576. " Type,tFA----,",
  577. " Edit,uf0----,Run >NIL: E",
  578. " Show,sF0----,",
  579. " Run ,ufR----,Run >NIL:",
  580. "PatSe,jAp----,",
  581.  
  582. "WORK:,D00----,WORK:",
  583. "SYS: ,D00----,SYS:",
  584. "DH1: ,D00----,DH1:",
  585. "DH0: ,D00----,DH0:",
  586. "DF1: ,D00----,DF1:",
  587. "DF0: ,D00----,DF0:",
  588. "RAM: ,D00----,RAM:",
  589. " RAM:,D00----,RAM:",
  590. " DF0:,D00----,DF0:",
  591. " DF1:,D00----,DF1:",
  592. " DH0:,D00----,DH0:",
  593. " DH1:,D00----,DH1:",
  594. " SYS:,D00----,SYS:",
  595. "WORK:,D00----,WORK:",
  596.  
  597. Small buttons:-
  598.  
  599. "All  ,jAf----,",
  600. "None ,jBB----,",
  601. "CD   ,C00----,",
  602. "<<   ,E00----,",
  603. "<>SWA,W00----,",
  604. ">>   ,E00----,",
  605. "CD   ,C00----,",
  606. "None ,jBB----,",
  607. "All  ,jAf----,",
  608.  
  609. Left double click instant actions:-
  610.  
  611. "MOD. ,uFf----,Intuitracker",
  612. ".ARC ,uFp----,Arc v",
  613. ".DMS ,uFW----,DMS Write",
  614. ".LZH ,uFp----,LZ l",
  615. ".LHW ,uFW----,Lhwarp Write 0",
  616. ".PAK ,uFw----d",
  617. ".WRP ,uFW----,UnWarp",
  618. ".ZIP ,uFp----,UnZIP -v",
  619. ".ZOO ,uFp----,Zoo v",
  620. ".GIF ,uF0----,VirtGIF",
  621. ".INFO,sFi----,",
  622. ".8SVX,pF0----,",
  623. ".ANIM,uF0----,ShowANIM",
  624. ".ILBM,sF0----,",
  625. ".SMUS,uF0----,PlaySMUS",
  626. ".FTXT,uF0----,",
  627. ".Most,uFt----,Most",
  628. ".PP  ,tFA----,",
  629. ".Exec,000----,",
  630. ".Text,tFA----,",
  631. "Binry,tFH----,",
  632. ".LHA ,uFp----,LZ l",
  633. ".uue ,tFA----,",
  634. ".jpg ,uF0----,Run >NIL: JView",
  635.  
  636. Middle click instant actions:-
  637.  
  638. "MOD. ,uFf----,Run >NIL: Intuitracker",
  639. ".ARC ,uF0----dRun >NIL: Arc xw",
  640. ".DMS ,uF0----,Run >NIL: DMS Write",
  641. ".LZH ,uF0----dRun >NIL: LZ -m -x -r x",
  642. ".LHW ,uF0----,Run >NIL: Lhwarp Write 0",
  643. ".PAK ,uF0----dRun >NIL:",
  644. ".WRP ,uF0----,Run >NIL: UnWarp",
  645. ".ZIP ,uF0----dRun >NIL: UnZIP -xdo",
  646. ".ZOO ,uF0----dRun >NIL: Zoo xO//",
  647. ".GIF ,uF0----,Run >NIL: VirtGIF",
  648. ".INFO,sFi----,",
  649. ".8SVX,uF0----,Run >NIL: PlaySS",
  650. ".ANIM,uF0----,Run >NIL: ShowANIM",
  651. ".ILBM,uF0----,Run >NIL: Dpaint",
  652. ".SMUS,uF0----,Run >NIL: PlaySMUS",
  653. ".FTXT,uF0----,",
  654. ".Most,uFf----,Run >NIL: Most",
  655. ".PP  ,uF0----,Run >NIL: PowerPacker",
  656. ".Exec,uF0----,Run >NIL: ReSource",
  657. ".Text,uF0----,Run >NIL: E",
  658. "Binry,uFf----,Run >NIL: NewZAP",
  659. ".LHA ,uFw----dRun >NIL: LZ -m -x -r x",
  660. ".uue ,uF0----dRun >NIL: uudecode",
  661. ".jpg ,uF0----,Run >NIL: JView",
  662.  
  663. Right click instant actions:-
  664.  
  665. "MOD. ,uFf----,Run >NIL: Intuitracker",
  666. ".ARC ,uFw----dArc xw",
  667. ".DMS ,uFW----,DMS Write",
  668. ".LZH ,uFw----dLZ -m -x -r x",
  669. ".LHW ,uFW----,Lhwarp Write 0",
  670. ".PAK ,uFw----d",
  671. ".WRP ,uFR----,Run >NIL: UnWarp",
  672. ".ZIP ,uFw----dUnZIP -xdo",
  673. ".ZOO ,uFw----dZoo xO//",
  674. ".GIF ,uF0----,Run >NIL: VirtGIF",
  675. ".INFO,uFf----,Run >NIL: IconEdit",
  676. ".8SVX,uF0----,PlaySS",
  677. ".ANIM,uF0----,ShowANIM",
  678. ".ILBM,uF0----,Mostra",
  679. ".SMUS,uF0----,PlaySMUS",
  680. ".FTXT,uF0----,",
  681. ".Most,uFf----,Run >NIL: Most",
  682. ".PP  ,uF0----,PPShow",
  683. ".Exec,uFR----,",
  684. ".Text,uF0----,Run >NIL: E",
  685. "Binry,uFf----,Run >NIL: NewZAP",
  686. ".LHA ,uFw----dLZ -m -x -r x",
  687. ".uue ,uFw----duudecode",
  688. ".jpg ,uF0----,Run >NIL: JView",
  689.  
  690.  
  691. ----------------------------------------------------------------------------
  692.         The PopKey/Tools editing screen
  693. ----------------------------------------------------------------------------
  694.  
  695.     There is a slight difference between Button/Instant Actions and the
  696. PopKey/Tool configuration as the PopKey entry has no button name part and
  697. has @ at the start of each entry other wise they are the same.
  698.  
  699.          "@       ,       "
  700.            |||\__/||
  701.            ||| |  |+---------Arguments for operation.
  702.            ||| |  |          Also what appears as menu text.
  703.            ||| |  |          Must have something here for PopKey/Tools
  704.            ||| |  +-------------Special options
  705.            ||| +------  Keyboard combination (qualifier/keycode)
  706.            |||
  707.            |||
  708.            |||+-------------- Options for certain routines.
  709.            ||
  710.            ||
  711.            |+--------------- What needs to be selected to operate.
  712.            |    F=Selected Files. D=Selected Dirs.
  713.            |    B=Selected Files &/or Dirs.
  714.            |    A=All files/dirs even if not selected. 
  715.            |    f=special mode that allows some files or no files
  716.            |    0=irrelevant (This is usually the case for PopKey/Tools
  717.            |
  718.            +--------------- Internal routine the button uses.
  719.                      A capital letter signifies that the operation does
  720.                      not require selected files/dirs.  A lower case
  721.                      hence means the operation should require selected
  722.                      files/dirs.
  723.  
  724.  
  725.     So say you wanted to change the PopKey to wake up DirWork all you
  726. have to do is edit the Qualifier/KeyCode of the first entry.  First click
  727. out of the text gadget the press the key combination you want DirWork to
  728. wake up with.  The values for this key combination is shown on the right
  729. hand side of the display.  Just substitute those values for the one
  730. currently in the PopKey/Tool text gadget.
  731.  
  732. By pressing the * on the keypad you would have got Qual=00 & Key=5D :-
  733.  
  734. So "@A001922,DW in Memory" becomes "@A00005D,DW in Memory"
  735.      \_/\/\/
  736.       |  \ + The D KeyCode
  737.       |   + The CTRL SHIFT ALT Qualifier
  738.       + Remember this function part, A just happens to be awake function.
  739.  
  740.  
  741.     The most common thing you will add to you tools/popkey data are
  742. commands to execute external programs so an example is to make it so if we
  743. select "Paint" from the Tools menu or press Amiga-F2
  744.  
  745. So add to the PopKey/ToolData "@N004051,Run >NIL: Paint".
  746.  
  747. The N means execute external program, the first 0 means nothing needs to be
  748. selected in the file lists and the second means no options.  Then the next
  749. 4 numbers are the Quailfier/Keycode for LeftAmiga-F2 key combinations.
  750. Then After the , is the command to execute and this is the text that will
  751. show in the tools menu.
  752.  
  753. For more information on the N function (or any other as you can use all
  754. the functions that you can use to define a button, the captial letter
  755. functions are the ones you might use though) see the Button/Instant Action
  756. section.
  757.  
  758. ----------------------------------------------------------------------------
  759.     General details
  760. ----------------------------------------------------------------------------
  761.  
  762. Under Kickstart 2.0- to enter the Ctrl-J character in a text gadget you must
  763. turn off the IControl Preferences Miscellaneous Flag "Text gadget filter".
  764.  
  765.  
  766. For each button and PopKeyEntry you can specify a key combination consisting
  767. of special keys (Qualifiers) and the normal key.  Here are some values to
  768. help you.  But in DWEdit on the Button change screen and the PopKey/Tool
  769. screen you can just click out of any text gadget and the press any key
  770. combination and the values are displayed.
  771.  
  772.     Sample Qualifiers:    Sample RawKeys:
  773.        LSHIFT=$01        Esc=$45   F1=$50 to F10=$59
  774.        RSHIFT=$02          `=$00    1=$01 to   \=$0D    BS=$41
  775.        CTRL  =$08        Tab=$42    Q=$10 to   P=$19 to  ]=$1B
  776.        LALT  =$10                   A=$20 to   L=$28 to  '=$2A
  777.        RALT  =$20                   Z=$31 to   M=$37 to  /=$3A
  778.        LAMIGA=$40        Del=$46  Help=$5F  Return=$44 Space=$40
  779.        RAMIGA=$80        Up=$4C Down=$4D Left=$4F Right=$4E
  780.  
  781.                     Keypad RawKeys:
  782.  
  783.                 (=$5A to *=$5D   -=$4A     +=$
  784.                 0=$0F    .=$3C   Enter=$43
  785.  
  786.  
  787. History:    V1.41a    First release
  788.         V1.42a    Now loads the PopKey/Tools from 1.40 DW's
  789.             And some help/example text improvements.
  790.         V1.43a    Added CopyBut and more examples.
  791.         V1.50a    Added options.
  792.             Major improvement to button/instant action editing.
  793.         V1.51a
  794.         V1.60a
  795.         V1.61a
  796.         V1.62a    Print Config now allows you to cancel.
  797.  
  798.  
  799. Bye,
  800.     Chris Hames (Available for Amiga programming work)
  801.  
  802.